Embabel Agent Documentation/com.embabel.agent.api.tool.callback

Package-level declarations

Types

data class AfterIterationContext(val history: List<Message>, val iteration: Int, val toolCallsInIteration: List<ToolCall>) : CallbackContext

Context provided after each complete iteration in the tool loop. An iteration completes when all tool calls from a single LLM response have been processed.

AfterLlmCallContext

data class AfterLlmCallContext(val history: List<Message>, val iteration: Int, val response: Message, val usage: Usage?) : CallbackContext

Context provided after LLM returns a response, before tool calls are processed.

AfterToolResultContext

data class AfterToolResultContext(val history: List<Message>, val iteration: Int, val toolCall: ToolCall, val result: Tool.Result, val resultAsString: String) : CallbackContext

Context provided after each tool execution in the tool loop.

BeforeLlmCallContext

data class BeforeLlmCallContext(val history: List<Message>, val iteration: Int, val tools: List<Tool>, val tokenEstimate: Int? = null) : CallbackContext

Context provided before each LLM call in the tool loop.

CallbackContext

abstract class CallbackContext(val history: List<Message>, val iteration: Int)

Base class for all tool loop callback contexts. Provides common properties shared across all callback events.

SlidingWindowTransformer

class SlidingWindowTransformer(maxMessages: Int, preserveSystemMessages: Boolean = true) : ToolLoopTransformer

Transformer that maintains a sliding window of messages to manage context size.

ToolLoopCallback

interface ToolLoopCallback

Marker interface for tool loop lifecycle callbacks.

ToolLoopInspector

interface ToolLoopInspector : ToolLoopCallback

Read-only observer for tool loop lifecycle events. Use for logging, metrics, debugging - does not modify state.

ToolLoopLoggingInspector

class ToolLoopLoggingInspector(logLevel: ToolLoopLoggingInspector.LogLevel = LogLevel.DEBUG, logger: <Error class: unknown class> = LoggerFactory.getLogger(ToolLoopLoggingInspector::class.java)) : ToolLoopInspector

Inspector that logs tool loop lifecycle events.

ToolLoopTransformer

interface ToolLoopTransformer : ToolLoopCallback

Transforms message history or tool results during tool loop execution. Use for compression, summarization, windowing.

ToolResultTruncatingTransformer

class ToolResultTruncatingTransformer(maxLength: Int, truncationMarker: String? = null, logLevel: ToolLoopLoggingInspector.LogLevel? = null, logger: <Error class: unknown class> = LoggerFactory.getLogger(ToolResultTruncatingTransformer::class.java)) : ToolLoopTransformer

Transformer that truncates tool results exceeding a maximum length.